home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat1 / array.z / array
Encoding:
Text File  |  2001-04-17  |  12.4 KB  |  265 lines
  1.  
  2.  
  3.  
  4. aaaarrrrrrrraaaayyyy((((1111))))                                                              aaaarrrrrrrraaaayyyy((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      array - execute an array command
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      aaaarrrrrrrraaaayyyy [[[[ooooppppttttiiiioooonnnnssss............]]]] _c_o_m_m_a_n_d [_a_r_g_s...]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The _a_r_r_a_y command is used to execute the aaaarrrrrrrraaaayyyy ccccoooommmmmmmmaaaannnndddd specifed by
  16.      "_c_o_m_m_a_n_d _a_r_g_s..." on one or more machines in an array and display the
  17.      resulting output on stdout.  An array command is not necessarily the same
  18.      thing as a UNIX command.  It is passed to _a_r_r_a_y_d(1M), the array services
  19.      daemon, which is responsible for translating it to an actual UNIX command
  20.      and executing it on the machines that make up the array.  Several array
  21.      commands are available by default; these are described below.
  22.  
  23.      _a_r_r_a_y takes several options.  The first token on the command line that
  24.      does not constitute a valid option is assumed to mark the beginning of
  25.      the array command.  None of the remaining tokens will be examined by
  26.      _a_r_r_a_y, other than to pass them along as arguments to the array command
  27.      itself.
  28.  
  29.      The valid options include:
  30.  
  31.      _----_aaaa _a_r_r_a_y_n_a_m_e or _----_aaaa_rrrr_rrrr_aaaa_yyyy _a_r_r_a_y_n_a_m_e
  32.           Specifies the name of the array to which this command should be
  33.           directed.  If not specified, the array services daemon's default
  34.           destination will be used.
  35.  
  36.      _----_DDDD or _----_dddd_iiii_rrrr_eeee_cccc_tttt
  37.           When used with _----_ssss, indicates that the request should be sent
  38.           directly to the specified server, rather than forwarded to that
  39.           server by the local array services daemon.  This will fail on
  40.           systems that use array services authentication unless the ----KKKKllll and
  41.           ----KKKKrrrr options are also specified.  _----_DDDD is the default behavior under
  42.           normal circumstances (but see the description of the _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______FFFF_OOOO_RRRR_WWWW_AAAA_RRRR_DDDD
  43.           variable, below).
  44.  
  45.      _----_FFFF or _----_ffff_oooo_rrrr_wwww_aaaa_rrrr_dddd
  46.           When used with _----_ssss, indicates that the request should be forwarded to
  47.           the specified server via the local array services daemon, rather
  48.           than sent directly to it.  _----_FFFF will become the default behavior if
  49.           the value of the _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______FFFF_OOOO_RRRR_WWWW_AAAA_RRRR_DDDD environment variable begins with the
  50.           letter "Y" (as in "yes"; it may be in either upper or lower case).
  51.  
  52.      _----_gggg or _----_gggg_llll_oooo_bbbb_aaaa_llll
  53.           Global command: indicates that the array command should be run in a
  54.           new global array session, that is, a new array session that has been
  55.           assigned a fresh global array session handle.
  56.  
  57.      _----_KKKK_llll _k_e_y or _----_llll_oooo_cccc_aaaa_llll_kkkk_eeee_yyyy _k_e_y
  58.           Use _k_e_y for the local authentication key when communicating directly
  59.           with a remote array services daemon.  _k_e_y is an unsigned 64-bit
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaarrrrrrrraaaayyyy((((1111))))                                                              aaaarrrrrrrraaaayyyy((((1111))))
  71.  
  72.  
  73.  
  74.           value.  The default local key is obtained from the environment
  75.           variable _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______LLLL_OOOO_CCCC_AAAA_LLLL_KKKK_EEEE_YYYY; if that does not exist, no key is used.
  76.           The actual role played by _k_e_y depends on the authentication method
  77.           used by array services in a particular configuration.  In general,
  78.           it is not used when communicating with an array services daemon on
  79.           the local machine.
  80.  
  81.      _----_KKKK_rrrr _k_e_y or _----_rrrr_eeee_mmmm_oooo_tttt_eeee_kkkk_eeee_yyyy _k_e_y
  82.           Use _k_e_y for the remote authentication key when communicating
  83.           directly with a remote array services daemon.  _k_e_y is an unsigned
  84.           64-bit value.  The default remote key is obtained from the
  85.           environment variable _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______RRRR_EEEE_MMMM_OOOO_TTTT_EEEE_KKKK_EEEE_YYYY; if that does not exist, no
  86.           key is used.  The actual role played by _k_e_y depends on the
  87.           authentication method used by array services in a particular
  88.           configuration.  In general, it is not used when communicating with
  89.           an array services daemon on the local machine.
  90.  
  91.      _----_llll or _----_llll_oooo_cccc_aaaa_llll
  92.           Local request: indicates that the request should not be propagated
  93.           to other machines.  This could be useful for testing a new array
  94.           command.
  95.  
  96.      _----_pppp _p_o_r_t or _----_pppp_oooo_rrrr_tttt _p_o_r_t
  97.           Specifies the port address of the array services daemon.  Defaults
  98.           to the value of the "ARRAYD_PORT" environment variable if present,
  99.           or the standard port number of the "sgi-arrayd" service otherwise.
  100.  
  101.      _----_qqqq or _----_qqqq_uuuu_iiii_eeee_tttt
  102.           Quiet: discard the output of the array command rather than sending
  103.           it to stdout.
  104.  
  105.      _----_ssss _s_e_r_v_e_r or _----_ssss_eeee_rrrr_vvvv_eeee_rrrr _s_e_r_v_e_r
  106.           Specifies the hostname or IP address of the array services daemon.
  107.           Defaults to the value of the "ARRAYD" environment variable if
  108.           present, or "localhost" otherwise.
  109.  
  110.      _----_tttt _v_a_l_u_e or _----_tttt_iiii_mmmm_eeee_oooo_uuuu_tttt _v_a_l_u_e
  111.           Specifies the timeout value (in seconds) used for waiting on a
  112.           single array services request.  Most commands involve one array
  113.           services daemon requesting services from another array services
  114.           daemon, so it will typically take two times this many seconds before
  115.           the _a_r_r_a_y command itself will timeout.  The default is 15 seconds
  116.           (so most array commands will timeout if no response is received in
  117.           _3_0 seconds).
  118.  
  119.      _----_vvvv   Verbose messages: display additional progress messages.  Repeated
  120.           occurrences (either "-v -v ..." or "-vv...") increases the
  121.           verbosity, although this is generally only useful for debugging
  122.           _a_r_r_a_y_d itself.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. aaaarrrrrrrraaaayyyy((((1111))))                                                              aaaarrrrrrrraaaayyyy((((1111))))
  137.  
  138.  
  139.  
  140. UUUUSSSSIIIINNNNGGGG AAAA RRRREEEEMMMMOOOOTTTTEEEE AAAARRRRRRRRAAAAYYYY SSSSEEEERRRRVVVVIIIICCCCEEEESSSS DDDDAAAAEEEEMMMMOOOONNNN
  141.      Ordinarily, the _a_r_r_a_y command uses the array services daemon running on
  142.      the local machine for processing requests.  However, there are some
  143.      circumstances where it is useful to contact an array services daemon on
  144.      another machine instead, such as when a smaller machine, perhaps running
  145.      IRIX 5.3 and therefore not capable of running an array services daemon,
  146.      is used as a console interface for an array.  There are two ways to
  147.      accomplish this.  If it is necessary to use a remote array services
  148.      daemon only infrequently, the ----ssss _s_e_r_v_e_r option can be specified on the
  149.      command line to indicate the hostname of the server that should be
  150.      contacted.  However, if the remote daemon will be used frequently or
  151.      exclusively (such as in the case where the local machine is being used as
  152.      a console interface to an array, and not as a member of the array itself)
  153.      then an easier approach is to set the environment variable AAAARRRRRRRRAAAAYYYYDDDD to the
  154.      hostname of the remote server.  If the ----ssss option is not specified, then
  155.      the _a_r_r_a_y command will use the value of that variable (if it is set)
  156.      rather than trying to contact an array services daemon on the local
  157.      machine.
  158.  
  159. DDDDEEEEFFFFAAAAUUUULLLLTTTT AAAARRRRRRRRAAAAYYYY CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
  160.      The default array services configuration includes several simple array
  161.      commands:
  162.  
  163.      aaaarrrrrrrraaaayyyy kkkkiiiillllllll _A_S_H
  164.           Sends a SIGTERM signal to all of the processes in the array that
  165.           belong to the array session specified by the handle _A_S_H.  By
  166.           default, SIGTERM will kill most processes, though shell programs are
  167.           often a notable exception.
  168.  
  169.      aaaarrrrrrrraaaayyyy ppppssss
  170.           Shows the array session handle, machine name, process ID, owner, run
  171.           time and command line for every process in the array that has a
  172.           non-zero array session handle.
  173.  
  174.      aaaarrrrrrrraaaayyyy rrrreeeessssuuuummmmeeee _A_S_H
  175.           Resumes all processes in the array that belong to the array session
  176.           specified by the handle _A_S_H by sending them the SIGCONT signal.
  177.           Presumably this array session had been suspended earlier with aaaarrrrrrrraaaayyyy
  178.           ssssuuuussssppppeeeennnndddd.
  179.  
  180.      aaaarrrrrrrraaaayyyy ssssiiiiggggnnnnaaaallll _s_i_g _A_S_H
  181.           Sends signal _s_i_g to all processes in the array that belong to the
  182.           array session specified by the handle _A_S_H.  This is simply a more
  183.           general version of the kill/suspend/resume commands.
  184.  
  185.      aaaarrrrrrrraaaayyyy ssssuuuussssppppeeeennnndddd _A_S_H
  186.           Suspends all processes in the array that belong to the array session
  187.           specified by the handle _A_S_H by sending them the SIGTSTP signal.
  188.  
  189.      aaaarrrrrrrraaaayyyy uuuuppppttttiiiimmmmeeee
  190.           Equivalent to running the _u_p_t_i_m_e(1) command on each machine in the
  191.           array.
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. aaaarrrrrrrraaaayyyy((((1111))))                                                              aaaarrrrrrrraaaayyyy((((1111))))
  203.  
  204.  
  205.  
  206.      aaaarrrrrrrraaaayyyy wwwwhhhhoooo
  207.           Shows the login name, current machine, origin machine and current
  208.           command for every logged-in user of the array.
  209.  
  210.      Note that the available array commands are controlled by the system
  211.      administrator, so some or all of these commands may not be present.
  212.      Other array commands may also be available.  Consult your system
  213.      adminstrator for more information.
  214.  
  215. NNNNOOOOTTTTEEEESSSS
  216.      The array services daemon (_a_r_r_a_y_d(1M)) must be running on all machines
  217.      that are to execute an array command.  It does not necessarily have to be
  218.      running on the machine that executes _a_r_r_a_y if an alternate server was
  219.      specified in some way.
  220.  
  221. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  222.      arrayd(1M), arrayd.conf(4).
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.